Skip to content

[Feat] [SDK-399] Add java agent for network telemetry events#374

Open
buongarzoni wants to merge 10 commits into
masterfrom
feat/SDK-399/add-java-agent-for-network-telemetry-events
Open

[Feat] [SDK-399] Add java agent for network telemetry events#374
buongarzoni wants to merge 10 commits into
masterfrom
feat/SDK-399/add-java-agent-for-network-telemetry-events

Conversation

@buongarzoni
Copy link
Copy Markdown
Collaborator

Description of the change

Add Java agent for automatic network telemetry capture

Auto-instruments all major HTTP clients via -javaagent: using ByteBuddy, capturing 4xx/5xx responses as Rollbar telemetry events with zero code changes required from the user.

Caution

This module targets JVM-based applications only. Android is not supported — ART does not implement the java.lang.instrument API required by Java agents. Android users should use the existing rollbar-android module instead.

What's included:

  • New rollbar-java-agent module — shadow JAR with ByteBuddy bundled and relocated
  • Instruments HttpURLConnection, java.net.http.HttpClient, Apache HC 4.x and 5.x
  • URL sanitization (strips credentials, query params, fragment before recording)
  • Deduplication via WeakHashMap to handle re-entrant getResponseCode() calls and dual-advice firing on HttpClient
  • Integration tests using WireMock 3.x for each instrumented client
  • README with installation and manual testing guide

Usage:

  -javaagent:/path/to/rollbar-java-agent.jar
  Rollbar.init(withAccessToken("...")
      .telemetryEventTracker(RollbarAgent.getTelemetryTracker())
      .build());

Type of change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Maintenance
  • New release

Related issues

Shortcut stories and GitHub issues (delete irrelevant)

Checklists

Development

  • Lint rules pass locally
  • The code changed/added as part of this pull request has been covered with tests
  • All tests related to the changed code pass in development

Code review

  • This pull request has a descriptive title and information useful to a reviewer. There may be a screenshot or screencast attached
  • "Ready for review" label attached to the PR and reviewers assigned
  • Issue from task tracker has a link to this pull request
  • Changes have been reviewed by at least one other engineer

@linear-code
Copy link
Copy Markdown

linear-code Bot commented May 26, 2026

SDK-399

@buongarzoni
Copy link
Copy Markdown
Collaborator Author

@claude review

Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Code review skipped — your organization has reached its monthly code review spending cap.

An organization admin can view or raise the cap at claude.ai/admin-settings/claude-code. The cap resets at the start of the next billing period.

Once the cap resets or is raised, comment @claude review on this pull request to trigger a review.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ad0b2acf09

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@Advice.OnMethodExit(onThrowable = Throwable.class)
public static void onExit(
@Advice.Argument(0) HttpUriRequest request,
@Advice.Return HttpResponse response,
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Broaden Apache HC4 advice return binding

The advice binds @Advice.Return to HttpResponse, but the matcher also targets execute overloads that use a ResponseHandler and return generic T (erased to Object). In that case ByteBuddy cannot legally bind the return value to HttpResponse, so transformation can fail for CloseableHttpClient and telemetry for Apache HC4 calls will be missing at runtime. Restrict the matcher to response-returning overloads or change the advice signature to handle all matched return types safely.

Useful? React with 👍 / 👎.

@Advice.OnMethodExit(onThrowable = Throwable.class)
public static void onExit(
@Advice.Argument(0) ClassicHttpRequest request,
@Advice.Return ClassicHttpResponse response,
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Broaden Apache HC5 advice return binding

This advice has the same return-type mismatch as HC4: @Advice.Return ClassicHttpResponse is applied to methods selected only by name/first argument, which includes execute(..., HttpClientResponseHandler) overloads returning generic T (erased to Object). That mismatch can cause ByteBuddy to reject the advice application, leaving Apache HC5 requests uninstrumented in production code paths that rely on response handlers.

Useful? React with 👍 / 👎.

.type(ElementMatchers.isSubTypeOf(HttpClient.class))
.transform((b, typeDescription, classLoader, module, protectionDomain) ->
b.visit(Advice.to(SendAdvice.class)
.on(ElementMatchers.named("send")))
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Instrument Java HttpClient async path

The transformer only matches methods named send, so HttpClient.sendAsync(...) calls are never observed. Any 4xx/5xx or transport failures from async requests therefore produce no telemetry event, which creates a large blind spot because async is a common java.net.http.HttpClient usage pattern.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant